'\" t
.\"     Title: IPSEC_TNCFG
.\"    Author: Paul Wouters
.\" Generator: DocBook XSL Stylesheets v1.77.1 <http://docbook.sf.net/>
.\"      Date: 12/16/2012
.\"    Manual: Executable programs
.\"    Source: libreswan
.\"  Language: English
.\"
.TH "IPSEC_TNCFG" "8" "12/16/2012" "libreswan" "Executable programs"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ipsec_tncfg \- manipulate KLIPS virtual interfaces
.SH "SYNOPSIS"
.HP \w'\fBipsec\fR\ 'u
\fBipsec\fR tncfg
.br
ipsec\ tncfg \-\-create \fIvirtual\fR
.br
ipsec\ tncfg \-\-delete \fIvirtual\fR
.br
ipsec\ tncfg \-\-attach \-\-virtual \fIvirtual\fR \-\-physical \fIphysical\fR
.br
ipsec\ tncfg \-\-detach \-\-virtual \fIvirtual\fR
.br
ipsec\ tncfg \-\-clear
.br
ipsec\ tncfg \-\-version
.br
ipsec\ tncfg \-\-help
.SH "KLIPS"
.PP
Note that tncfg is only supported on the KLIPS stack which uses ipsecX interfaces bound to physical interfaces
.SH "DESCRIPTION"
.PP
The purpose of
\fItncfg\fR
is to attach/detach IPsec virtual interfaces (e\&.g\&. ipsec0) to/from physical interfaces (e\&.g\&. eth0) through which packets will be forwarded once processed by KLIPS\&.
.PP
When using the MAST stack, tncfg is used to create and delete virtual interfaces known as mastXXX\&. mast stands for Mooring and XXX\&.
.PP
The form with no additional arguments lists the contents of /proc/net/ipsec_tncfg\&. The format of /proc/net/ipsec_tncfg is discussed in ipsec_tncfg(5)\&.
.PP
The
\fB\-\-attach\fR
form attaches the
\fIvirtual\fR
interface to the
\fIphysical\fR
one\&.
.PP
The
\fB\-\-detach\fR
form detaches the
\fIvirtual\fR
interface from whichever physical interface it is attached to\&.
.PP
The
\fB\-\-clear\fR
form clears all the
\fIvirtual\fR
interfaces from whichever physical interfaces they were attached to\&.
.PP
Virtual interfaces typically have names like
\fBipsec0\fR
or
\fBmast0\fR
while physical interfaces typically have names like
\fBeth0\fR
or
\fBppp0\fR\&.
.SH "EXAMPLES"
.PP
\fBipsec tncfg \-\-create mast12\fR
.RS 4
creates the mast12 device\&.
.RE
.PP
\fBipsec tncfg \-\-create ipsec4\fR
.RS 4
creates an ipsec4 device, but does not attach it\&.
.RE
.PP
\fBipsec tncfg \-\-attach \-\-virtual ipsec0 \-\-physical eth0\fR
.RS 4
attaches the
\fBipsec0\fR
virtual device to the
\fBeth0\fR
physical device\&.
.RE
.SH "FILES"
.PP
/proc/net/ipsec_tncfg, /usr/local/bin/ipsec
.SH "SEE ALSO"
.PP
ipsec(8), ipsec_manual(8), ipsec_eroute(8), ipsec_spi(8), ipsec_spigrp(8), ipsec_klipsdebug(8), ipsec_tncfg(5)
.SH "HISTORY"
.PP
Written for the Linux FreeS/WAN project <\m[blue]\fBhttp://www\&.freeswan\&.org/\fR\m[]> by Richard Guy Briggs\&.
.SH "AUTHOR"
.PP
\fBPaul Wouters\fR
.RS 4
placeholder to suppress warning
.RE
